package com.example.stuwork.dao;

import com.example.stuwork.pojo.AssignmentAllocation;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 作业分配DAO接口
 */
@Mapper
public interface AssignmentAllocationDao {
    
    /**
     * 获取所有作业分配
     * 
     * @return 作业分配列表
     */
    List<AssignmentAllocation> findAll();
    
    /**
     * 根据ID获取作业分配
     * 
     * @param allocationId 分配ID
     * @return 作业分配对象
     */
    AssignmentAllocation getById(Long allocationId);
    
    /**
     * 根据作业ID获取作业分配列表
     * 
     * @param assignmentId 作业ID
     * @return 作业分配列表
     */
    List<AssignmentAllocation> findByAssignmentId(Long assignmentId);
    
    /**
     * 根据学生ID获取作业分配列表
     * 
     * @param studentId 学生ID
     * @return 作业分配列表
     */
    List<AssignmentAllocation> findByStudentId(String studentId);
    
    /**
     * 根据作业ID和学生ID获取作业分配
     * 
     * @param assignmentId 作业ID
     * @param studentId 学生ID
     * @return 作业分配对象
     */
    AssignmentAllocation findByAssignmentIdAndStudentId(
        @Param("assignmentId") Long assignmentId, 
        @Param("studentId") String studentId
    );
    
    /**
     * 根据作业ID获取该作业的提交统计
     * 
     * @param assignmentId 作业ID
     * @return 包含统计信息的对象，如总数、已提交数、已批改数等
     */
    AssignmentAllocationStats getStatsByAssignmentId(Long assignmentId);
    
    /**
     * 根据作业ID和状态获取作业分配列表
     * 
     * @param assignmentId 作业ID
     * @param status 状态
     * @return 作业分配列表
     */
    List<AssignmentAllocation> findByAssignmentIdAndStatus(
        @Param("assignmentId") Long assignmentId, 
        @Param("status") Integer status
    );
    
    /**
     * 添加作业分配
     * 
     * @param allocation 作业分配对象
     * @return 影响的行数
     */
    int insert(AssignmentAllocation allocation);
    
    /**
     * 批量添加作业分配
     * 
     * @param allocations 作业分配对象列表
     * @return 影响的行数
     */
    int batchInsert(List<AssignmentAllocation> allocations);
    
    /**
     * 更新作业分配
     * 
     * @param allocation 作业分配对象
     * @return 影响的行数
     */
    int update(AssignmentAllocation allocation);
    
    /**
     * 更新作业分配状态
     * 
     * @param allocationId 分配ID
     * @param status 状态
     * @return 影响的行数
     */
    int updateStatus(@Param("allocationId") Long allocationId, @Param("status") Integer status);
    
    /**
     * 更新作业提交ID
     * 
     * @param allocationId 分配ID
     * @param submissionId 提交ID
     * @param status 状态
     * @return 影响的行数
     */
    int updateSubmissionId(
        @Param("allocationId") Long allocationId, 
        @Param("submissionId") Long submissionId,
        @Param("status") Integer status
    );
    
    /**
     * 更新作业分配评分
     * 
     * @param allocationId 分配ID
     * @param score 分数
     * @return 影响的行数
     */
    int updateScore(@Param("allocationId") Long allocationId, @Param("score") Integer score);
    
    /**
     * 删除作业分配
     * 
     * @param allocationId 分配ID
     * @return 影响的行数
     */
    int delete(Long allocationId);
    
    /**
     * 根据作业ID删除所有相关的作业分配
     * 
     * @param assignmentId 作业ID
     * @return 影响的行数
     */
    int deleteByAssignmentId(Long assignmentId);
    
    /**
     * 检查是否已存在特定学生的作业分配
     * 
     * @param assignmentId 作业ID
     * @param studentId 学生ID
     * @return 是否存在
     */
    boolean existsByAssignmentIdAndStudentId(
        @Param("assignmentId") Long assignmentId, 
        @Param("studentId") String studentId
    );
} 